home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / Prog / T / Thinkcup.cpt / TCL Demo Update / TCL Demo Update Doc next >
Encoding:
Text File  |  1990-03-14  |  5.9 KB  |  202 lines  |  [TEXT/KAHL]
  1. TCL DEMO UPDATE INSTRUCTIONS
  2. ============================
  3. Copyright © 1990 Symantec Corporation. All rights reserved.
  4. 3/15/90
  5.  
  6. INTRODUCTION
  7. ============
  8. Since the release of THINK C 4.0, a few bugs have been found in the
  9. TCL Demo programs (Starter, TinyEdit, and Art Class).  This 
  10. update modifies the appropriate source files to fix these bugs.
  11.  
  12. This update uses a program called AutoWeave to create new demo source
  13. files from your existing files. It applies a set of "differences" files
  14. to the original demo program source files that came with your THINK C
  15. package to create new updated source files.
  16.  
  17. There are two things to watch out for:
  18.  
  19.     •    The AutoWeave program assumes that all of the Starter and
  20.         TinyEdit files are in the same folder. And that the ArtClass
  21.         files are divided into two folders called "Art Class Sources"
  22.         and "Art Class Headers"
  23.     
  24.     •    If you modified any of the original source files, you
  25.         should move them to a different folder or rename them.
  26.         Otherwise, the AutoWeave program will replace them with
  27.         updated versions, and your changes will be lost.
  28.         
  29.     NOTE    After you apply this update, you should use Starter as your
  30.             base TCL project and ignore Pedestal. One of the things
  31.             that this update does is fold the important code and comments
  32.             from Pedestal into Starter.
  33.     
  34. HOW TO USE IT
  35. =============
  36.     ••    Please read through these instructions before you begin.
  37.  
  38.     0.    Be sure that you have your original THINK C 2 and
  39.         THINK C 4 disks from your THINK C 4.0 package.
  40.  
  41.         •    If you haven't done so already, update your THINK Class
  42.         •    Library folder before you do this update.
  43.  
  44.     1.    Double-click on the file named "TCL Demo Update.Script"
  45.         to launch the AutoWeave program.
  46.         
  47.     2.    The AutoWeave program will ask you to locate the original "TCL
  48.         Demos" folder.  Insert your THINK C 2 disk in the floppy drive,
  49.         select the "TCL Demos" folder and click OK.
  50.         
  51.     3.    The AutoWeave program will ask you to locate your copy of the "TCL
  52.         Demos" folder.  This is where the modified files will be
  53.         written (overwriting the old versions). Select the appropriate
  54.         folder and click OK.
  55.         
  56.     4.    The AutoWeave program will ask you to locate the original
  57.         "Art Class Folder".  Insert your THINK C 4 disk (eject the THINK
  58.         C 2 disk if you have a machine with one drive), select the folder
  59.         "Art Class Folder" folder and click OK.
  60.         
  61.     5.    The AutoWeave program will ask you to locate your copy of "Art Class
  62.         Folder".  This is where the modified files will be
  63.         written (overwriting the old versions). Select the appropriate
  64.         folder and click OK.
  65.         
  66.     6.    The AutoWeave program will ask you to locate the "TCL Demo Update
  67.         Diffs" folder.  This folder is supplied as part of this update.
  68.         Select this folder and click OK.  (Be sure not to select
  69.         "TCL Update Diffs" by mistake.)
  70.         
  71.     7.    The AutoWeave program will now modify the appropriate files, keeping
  72.         you informed of its progress.  When the Weaver has finished,
  73.         you may want to check one or two of the files, to make sure
  74.         that everything worked.  (For example, if you chose the 
  75.         wrong Diffs folder in step 6, the Weaver wouldn't actually
  76.         do anything, although it might act like it did.)
  77.         
  78.  
  79.  
  80. SUMMARY OF THE CHANGES
  81. ======================
  82. Art Class
  83. ---------
  84. 1.    CCaption.c    
  85.         FitToText no longer tests random byte for CARRIAGE_RETURN if
  86.         t->teLength == 0 (fixes TCL 8).
  87.         
  88. 2.    CAboutBox.h
  89.             Now #includes CApplication.h.
  90.         
  91.         IAboutBox parameter (itsSupervisor) is now a CApplication.
  92.         
  93. 3.    CAboutBox.c  
  94.         MouseOrKey now masks out the Caps Lock and Reset keys (fixes TCL 9).
  95.         
  96.         Now #includes CApplication.h.
  97.         
  98.         IAboutBox parameter (itsSupervisor) is now a CApplication.
  99.         
  100. 4.    CPaintPane.c  
  101.         Modified DoKeyDown to support scrolling keys on extended keyboards.
  102.         
  103.         DoCopy and DoPaste now dispose of the temporary PicHandles which 
  104.         they create.
  105.         
  106. 5.    CArtClassApp.c  
  107.         SetUpMenus now initializes gBartender with IBarOwner instead of
  108.         IBartender.
  109.         
  110. 6.    CArtClassDoc.h
  111.         Now #includes CApplication.h.
  112.         
  113.         IArtClassDoc parameter (aSupervisor) is now a CApplication.
  114.         
  115. 7.    CArtClassDoc.c
  116.         IArtClassDoc parameter (aSupervisor) is now a CApplication.
  117.         
  118. 8.    CPatternsDir.h
  119.         IPatternsDir parameter (aSupervisor) is now a CApplication.
  120.     
  121. 9.    CPatternsDir.c
  122.         IPatternsDir parameter (aSupervisor) is now a CApplication.
  123.         
  124. 10.    CToolsDir.h
  125.         IToolsDir parameter (aSupervisor) is now a CApplication.
  126.     
  127. 11.    CToolsDir.c
  128.         IToolsDir parameter (aSupervisor) is now a CApplication.
  129.         
  130.         
  131. TinyEdit
  132. --------        
  133. 12.    CEditPane.c  
  134.         Modified DoKeyDown and DoAutoKey to support scrolling keys on
  135.         extended keyboards.
  136.         
  137.         Now #includes Constants.h.
  138.         
  139.         DoCommand now sets the document's dirty bit and enables the Save
  140.         and Save As commands when a Cut is executed.
  141.         
  142. 13.    CEditDoc.h
  143.         Now #includes CApplication.h.
  144.         
  145.         IEditDoc parameter (aSupervisor) is now a CApplication.    
  146.         
  147. 14.    CEditDoc.c 
  148.         OpenFile now has correct RequestMemory calls bracketing 
  149.         theFile->ReadAll(&theData).
  150.     
  151.         IEditDoc parameter (aSupervisor) is now a CApplication.
  152.                 
  153.         
  154. Starter
  155. -------
  156. 15.    CStarterApp.h
  157.         Added declarations for SetUpMenus and UpdateMenus functions.
  158.         
  159. 16.    CStarterDoc.h
  160.         Now #includes CApplication.h.
  161.         
  162.         IStarterDoc now requires aSupervisor to be a CApplication.
  163.  
  164.         Dispose method now specifies a void parameter list.
  165.         
  166.         Deleted declarations of Activate and Deactivate methods.
  167.         
  168.         Added declaration of UpdateMenus method.
  169.         
  170. 17.    CStarterApp.c
  171.         Added copyright notice.
  172.         
  173.         Added comment to IStarterApp method.
  174.         
  175.         Added SetUpMenus method.
  176.         
  177.         Added UpdateMenus method.
  178.         
  179. 18.    CStarterDoc.c
  180.         Added copyright notice.
  181.         
  182.         IStarterDoc's first parameter (aSupervisor) is now a CApplication.
  183.         
  184.         Deleted the Activate and Deactivate methods.
  185.         
  186.         Added the UpdateMenus method.
  187.         
  188.         Added code to NewFile to give each new window a unique title.
  189.         
  190.         OpenFile now has correct RequestMemory calls bracketing theFile->
  191.         ReadAll(...).
  192.         
  193.         Added comments to BuildWindow method.
  194.         
  195. 19.    CStarterPane.c
  196.         Added copyright notice.
  197.         
  198.         Modified a couple of comments.
  199.         
  200. 20.    Starter.c
  201.         Added copyright notice.
  202.